<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>set_compute_device_param [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_system.html">系统</a> / <a href="toc_system_computedevices.html">计算设备</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">set_compute_device_param</span><span data-if="c" style="display:none;">T_set_compute_device_param</span><span data-if="cpp" style="display:none;">SetComputeDeviceParam</span><span data-if="dotnet" style="display:none;">SetComputeDeviceParam</span><span data-if="python" style="display:none;">set_compute_device_param</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">set_compute_device_param</span><span data-if="c" style="display:none;">T_set_compute_device_param</span><span data-if="cpp" style="display:none;">SetComputeDeviceParam</span><span data-if="dotnet" style="display:none;">SetComputeDeviceParam</span><span data-if="python" style="display:none;">set_compute_device_param</span></code> — Set parameters of an compute device.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>set_compute_device_param</b>( :  : <a href="#DeviceHandle"><i>DeviceHandle</i></a>, <a href="#GenParamName"><i>GenParamName</i></a>, <a href="#GenParamValue"><i>GenParamValue</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_set_compute_device_param</b>(const Htuple <a href="#DeviceHandle"><i>DeviceHandle</i></a>, const Htuple <a href="#GenParamName"><i>GenParamName</i></a>, const Htuple <a href="#GenParamValue"><i>GenParamValue</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>SetComputeDeviceParam</b>(const HTuple&amp; <a href="#DeviceHandle"><i>DeviceHandle</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>)</code></p>
<p>
<code>void <a href="HComputeDevice.html">HComputeDevice</a>::<b>SetComputeDeviceParam</b>(const HString&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>) const</code></p>
<p>
<code>void <a href="HComputeDevice.html">HComputeDevice</a>::<b>SetComputeDeviceParam</b>(const HString&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HString&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>) const</code></p>
<p>
<code>void <a href="HComputeDevice.html">HComputeDevice</a>::<b>SetComputeDeviceParam</b>(const char* <a href="#GenParamName"><i>GenParamName</i></a>, const char* <a href="#GenParamValue"><i>GenParamValue</i></a>) const</code></p>
<p>
<code>void <a href="HComputeDevice.html">HComputeDevice</a>::<b>SetComputeDeviceParam</b>(const wchar_t* <a href="#GenParamName"><i>GenParamName</i></a>, const wchar_t* <a href="#GenParamValue"><i>GenParamValue</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>SetComputeDeviceParam</b>(<a href="HTuple.html">HTuple</a> <a href="#DeviceHandle"><i>deviceHandle</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
<p>
<code>void <a href="HComputeDevice.html">HComputeDevice</a>.<b>SetComputeDeviceParam</b>(string <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
<p>
<code>void <a href="HComputeDevice.html">HComputeDevice</a>.<b>SetComputeDeviceParam</b>(string <a href="#GenParamName"><i>genParamName</i></a>, string <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>set_compute_device_param</b>(<a href="#DeviceHandle"><i>device_handle</i></a>: HHandle, <a href="#GenParamName"><i>gen_param_name</i></a>: str, <a href="#GenParamValue"><i>gen_param_value</i></a>: MaybeSequence[Union[str, int, float]]) -&gt; None</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">set_compute_device_param</span><span data-if="c" style="display:none">set_compute_device_param</span><span data-if="cpp" style="display:none">SetComputeDeviceParam</span><span data-if="com" style="display:none">SetComputeDeviceParam</span><span data-if="dotnet" style="display:none">SetComputeDeviceParam</span><span data-if="python" style="display:none">set_compute_device_param</span></code> sets parameters of the
compute device <a href="#DeviceHandle"><i><code><span data-if="hdevelop" style="display:inline">DeviceHandle</span><span data-if="c" style="display:none">DeviceHandle</span><span data-if="cpp" style="display:none">DeviceHandle</span><span data-if="com" style="display:none">DeviceHandle</span><span data-if="dotnet" style="display:none">deviceHandle</span><span data-if="python" style="display:none">device_handle</span></code></i></a> for the current HALCON thread.
</p>
<p>The following parameters can be set:
</p>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'alloc_pinned'</span><span data-if="c" style="display:none">"alloc_pinned"</span><span data-if="cpp" style="display:none">"alloc_pinned"</span><span data-if="com" style="display:none">"alloc_pinned"</span><span data-if="dotnet" style="display:none">"alloc_pinned"</span><span data-if="python" style="display:none">"alloc_pinned"</span></i></b></dt>
<dd>
<p>

If <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>, the output image matrices of all operators
(executed on the compute device or not) called in the
current HALCON thread are created in page locked
(so called 'pinned') memory.
This accelerates the transfer between host and device
memory. However, too excessive usage of page locked memory
may have a negative impact on overall system performance.
You should activate page locked memory allocation if
the output image of of the next operator call is to be
transferred to the device.
Page locked memory allocation should be deactivated for
all operator calls whose output images are not required
on the compute device (see example).</p>
<p>
<span class="pardesc"><span class="parcat">List of values:
      </span></span>   <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>, <i><span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span></i>.</p>
<p>
<span class="pardesc"><span class="parcat">Default:
      </span></span> <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'asynchronous_execution'</span><span data-if="c" style="display:none">"asynchronous_execution"</span><span data-if="cpp" style="display:none">"asynchronous_execution"</span><span data-if="com" style="display:none">"asynchronous_execution"</span><span data-if="dotnet" style="display:none">"asynchronous_execution"</span><span data-if="python" style="display:none">"asynchronous_execution"</span></i></b></dt>
<dd>
<p>

If <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>, operators executed on the compute device
do not wait for the device computations to finish but
return after initiating the computations.
All device computations are synchronized as soon as
the output of a compute device operation is used on
the CPU (e.g., by <a href="disp_image.html"><code><span data-if="hdevelop" style="display:inline">disp_image</span><span data-if="c" style="display:none">disp_image</span><span data-if="cpp" style="display:none">DispImage</span><span data-if="com" style="display:none">DispImage</span><span data-if="dotnet" style="display:none">DispImage</span><span data-if="python" style="display:none">disp_image</span></code></a>).</p>
<p>
<span class="pardesc"><span class="parcat">List of values:
      </span></span>   <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>, <i><span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span></i>.</p>
<p>
<span class="pardesc"><span class="parcat">Default:
      </span></span> <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'buffer_cache_capacity'</span><span data-if="c" style="display:none">"buffer_cache_capacity"</span><span data-if="cpp" style="display:none">"buffer_cache_capacity"</span><span data-if="com" style="display:none">"buffer_cache_capacity"</span><span data-if="dotnet" style="display:none">"buffer_cache_capacity"</span><span data-if="python" style="display:none">"buffer_cache_capacity"</span></i></b></dt>
<dd>
<p>

Maximum size (in bytes) of the compute device buffer
cache.</p>
<p>
<span class="pardesc"><span class="parcat">Default:
      </span></span> 1/3 of the available device memory
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'image_cache_capacity'</span><span data-if="c" style="display:none">"image_cache_capacity"</span><span data-if="cpp" style="display:none">"image_cache_capacity"</span><span data-if="com" style="display:none">"image_cache_capacity"</span><span data-if="dotnet" style="display:none">"image_cache_capacity"</span><span data-if="python" style="display:none">"image_cache_capacity"</span></i></b></dt>
<dd>
<p>

Maximum size (in bytes) of the compute device image
cache.</p>
<p>
<span class="pardesc"><span class="parcat">Default:
      </span></span> 1/3 of the available device memory
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'pinned_mem_cache_capacity'</span><span data-if="c" style="display:none">"pinned_mem_cache_capacity"</span><span data-if="cpp" style="display:none">"pinned_mem_cache_capacity"</span><span data-if="com" style="display:none">"pinned_mem_cache_capacity"</span><span data-if="dotnet" style="display:none">"pinned_mem_cache_capacity"</span><span data-if="python" style="display:none">"pinned_mem_cache_capacity"</span></i></b></dt>
<dd>
<p>

Maximum size (in bytes) of the page locked (pinned) memory
cache.</p>
<p>
<span class="pardesc"><span class="parcat">Default:
      </span></span> <i>32000000</i> (32MByte)
</p>
</dd>
</dl>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="DeviceHandle" class="parname"><b><code><span data-if="hdevelop" style="display:inline">DeviceHandle</span><span data-if="c" style="display:none">DeviceHandle</span><span data-if="cpp" style="display:none">DeviceHandle</span><span data-if="com" style="display:none">DeviceHandle</span><span data-if="dotnet" style="display:none">deviceHandle</span><span data-if="python" style="display:none">device_handle</span></code></b> (input_control)  </span><span>compute_device <code>→</code> <span data-if="dotnet" style="display:none"><a href="HComputeDevice.html">HComputeDevice</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Compute device handle.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Name of the parameter to set.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'buffer_cache_capacity'</span>
    <span data-if="c" style="display:none">"buffer_cache_capacity"</span>
    <span data-if="cpp" style="display:none">"buffer_cache_capacity"</span>
    <span data-if="com" style="display:none">"buffer_cache_capacity"</span>
    <span data-if="dotnet" style="display:none">"buffer_cache_capacity"</span>
    <span data-if="python" style="display:none">"buffer_cache_capacity"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'alloc_pinned'</span><span data-if="c" style="display:none">"alloc_pinned"</span><span data-if="cpp" style="display:none">"alloc_pinned"</span><span data-if="com" style="display:none">"alloc_pinned"</span><span data-if="dotnet" style="display:none">"alloc_pinned"</span><span data-if="python" style="display:none">"alloc_pinned"</span>, <span data-if="hdevelop" style="display:inline">'asynchronous_execution'</span><span data-if="c" style="display:none">"asynchronous_execution"</span><span data-if="cpp" style="display:none">"asynchronous_execution"</span><span data-if="com" style="display:none">"asynchronous_execution"</span><span data-if="dotnet" style="display:none">"asynchronous_execution"</span><span data-if="python" style="display:none">"asynchronous_execution"</span>, <span data-if="hdevelop" style="display:inline">'buffer_cache_capacity'</span><span data-if="c" style="display:none">"buffer_cache_capacity"</span><span data-if="cpp" style="display:none">"buffer_cache_capacity"</span><span data-if="com" style="display:none">"buffer_cache_capacity"</span><span data-if="dotnet" style="display:none">"buffer_cache_capacity"</span><span data-if="python" style="display:none">"buffer_cache_capacity"</span>, <span data-if="hdevelop" style="display:inline">'image_cache_capacity'</span><span data-if="c" style="display:none">"image_cache_capacity"</span><span data-if="cpp" style="display:none">"image_cache_capacity"</span><span data-if="com" style="display:none">"image_cache_capacity"</span><span data-if="dotnet" style="display:none">"image_cache_capacity"</span><span data-if="python" style="display:none">"image_cache_capacity"</span>, <span data-if="hdevelop" style="display:inline">'pinned_mem_cache_capacity'</span><span data-if="c" style="display:none">"pinned_mem_cache_capacity"</span><span data-if="cpp" style="display:none">"pinned_mem_cache_capacity"</span><span data-if="com" style="display:none">"pinned_mem_cache_capacity"</span><span data-if="dotnet" style="display:none">"pinned_mem_cache_capacity"</span><span data-if="python" style="display:none">"pinned_mem_cache_capacity"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamValue" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[Union[str, int, float]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string / </span><span data-if="hdevelop" style="display:inline">integer / </span><span data-if="hdevelop" style="display:inline">real)</span><span data-if="dotnet" style="display:none"> (<i>string</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long / </span><span data-if="dotnet" style="display:none">double)</span><span data-if="cpp" style="display:none"> (<i>HString</i> / </span><span data-if="cpp" style="display:none">Hlong / </span><span data-if="cpp" style="display:none">double)</span><span data-if="c" style="display:none"> (<i>char*</i> / </span><span data-if="c" style="display:none">Hlong / </span><span data-if="c" style="display:none">double)</span></span>
</div>
<p class="pardesc">New parameter value.</p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
activate_compute_device (DeviceHandle)
read_image (Image, 'fuse')
set_compute_device_param (DeviceHandle, 'alloc_pinned', 'true')
* filter on compute device, output image is page locked
derivate_gauss (Image, DerivGauss, 3, 'gradient')
* filter result on the CPU, output image should not be page locked
set_compute_device_param (DeviceHandle, 'alloc_pinned', 'false')
median_image (DerivGauss, ImageMedian, 'circle', 1, 'mirrored')
</pre>
<h2 id="sec_result">结果</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">set_compute_device_param</span><span data-if="c" style="display:none">set_compute_device_param</span><span data-if="cpp" style="display:none">SetComputeDeviceParam</span><span data-if="com" style="display:none">SetComputeDeviceParam</span><span data-if="dotnet" style="display:none">SetComputeDeviceParam</span><span data-if="python" style="display:none">set_compute_device_param</span></code> returns the
value <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     如果参数都是正确的。 Otherwise
an exception will be raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="activate_compute_device.html"><span data-if="hdevelop" style="display:inline">activate_compute_device</span><span data-if="c" style="display:none">activate_compute_device</span><span data-if="cpp" style="display:none">ActivateComputeDevice</span><span data-if="com" style="display:none">ActivateComputeDevice</span><span data-if="dotnet" style="display:none">ActivateComputeDevice</span><span data-if="python" style="display:none">activate_compute_device</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="get_compute_device_param.html"><span data-if="hdevelop" style="display:inline">get_compute_device_param</span><span data-if="c" style="display:none">get_compute_device_param</span><span data-if="cpp" style="display:none">GetComputeDeviceParam</span><span data-if="com" style="display:none">GetComputeDeviceParam</span><span data-if="dotnet" style="display:none">GetComputeDeviceParam</span><span data-if="python" style="display:none">get_compute_device_param</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
